Document the new signals popup, popdown and move-active.

2007-08-08  Mikael Hallendal  <micke@imendio.com>

	* gtk/gtkcombobox.c (gtk_combo_box_class_init):
	Document the new signals popup, popdown and move-active.

svn path=/trunk/; revision=18594

diff --git a/ChangeLog b/ChangeLog
index 4d4f358d8ea6b7d12b6975d93476b3083eef6532..822bce716cbef453c20dc169ddb0a7aa015db6a3 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2007-08-08  Mikael Hallendal  <micke@imendio.com>
+
+       * gtk/gtkcombobox.c (gtk_combo_box_class_init): 
+       Document the new signals popup, popdown and move-active.
+
 2007-08-07  Matthias Clasen  <mclasen@redhat.com>
        
        * MAINTAINERS: Follow new format regulations.

diff --git a/gtk/gtkcombobox.c b/gtk/gtkcombobox.c
index 234c9b7b0861d0779e813d6bf2e1f5ffdc73c7a0..6a440ff16169b83ec4fe6c93ed052e6a436e94c8 100644 (file)
--- a/gtk/gtkcombobox.c
+++ b/gtk/gtkcombobox.c
@@ -526,7 +526,17 @@ gtk_combo_box_class_init (GtkComboBoxClass *klass)
                   NULL, NULL,
                   g_cclosure_marshal_VOID__VOID,
                   G_TYPE_NONE, 0);
-
+  /**
+   * GtkComboBox::move-active:
+   * @widget: the object that received the signal
+   * @scroll_type: a #GtkScrollType
+   *
+   * The ::move-active signal is a 
+   * <link linkend="keybinding-signals">keybinding signal</link>
+   * which gets emitted to move the active selection.
+   *
+   * Since: 2.12
+   */
   combo_box_signals[MOVE_ACTIVE] =
     _gtk_binding_signal_new (I_("move-active"),
                              G_OBJECT_CLASS_TYPE (klass),
@@ -537,6 +547,18 @@ gtk_combo_box_class_init (GtkComboBoxClass *klass)
                              G_TYPE_NONE, 1,
                              GTK_TYPE_SCROLL_TYPE);
 
+  /**
+   * GtkComboBox::popup:
+   * @widget: the object that received the signal
+   *
+   * The ::popup signal is a 
+   * <link linkend="keybinding-signals">keybinding signal</link>
+   * which gets emitted to popup the combo box list.
+   *
+   * The default binding for this signal is Alt+Down.
+   *
+   * Since: 2.12
+   */
   combo_box_signals[POPUP] =
     _gtk_binding_signal_new (I_("popup"),
                              G_OBJECT_CLASS_TYPE (klass),
@@ -545,7 +567,18 @@ gtk_combo_box_class_init (GtkComboBoxClass *klass)
                              NULL, NULL,
                              g_cclosure_marshal_VOID__VOID,
                              G_TYPE_NONE, 0);
-
+  /**
+   * GtkComboBox::popdown:
+   * @button: the object which received the signal
+   *
+   * The ::popdown signal is a 
+   * <link linkend="keybinding-signals">keybinding signal</link> 
+   * which gets emitted to popdown the combo box list.
+   *
+   * The default bindings for this signal are Alt+Up and Escape.
+   *
+   * Since: 2.12
+   */
   combo_box_signals[POPDOWN] =
     _gtk_binding_signal_new (I_("popdown"),
                              G_OBJECT_CLASS_TYPE (klass),